home *** CD-ROM | disk | FTP | other *** search
/ Aminet 35 / Aminet 35 (2000)(Schatztruhe)[!][Feb 2000].iso / Aminet / disk / misc / SCSIQuery.readme < prev    next >
Encoding:
Text File  |  2000-01-02  |  10.1 KB  |  283 lines
  1. Short:    Prints internal infos of SCSI devices
  2. Author:   thor@einstein.math.tu-berlin.de (Thomas Richter)
  3. Uploader: thor@einstein.math.tu-berlin.de (Thomas Richter)
  4. Version:  1.33
  5. Type:     disk/misc
  6. Requires: Os 2.04, a true SCSI device (HD,CD mostly)
  7.  
  8. _____________________________________________________________________________
  9.  
  10. Changes made for 1.33:
  11.  
  12. - Some cosmetical changes in the output format.
  13. - The Iomega specific field "Format count" was incorrectly printed as
  14.   "BadFlag". Fixed.
  15. _____________________________________________________________________________
  16.  
  17. Changes made for 1.32:
  18.  
  19. - Added more support for Iomega, mainly JAZ related.
  20. _____________________________________________________________________________
  21.  
  22. Changes made for 1.30:
  23.  
  24. - Fixed a bug for the notch page output.
  25. - Added notch support, can be disabled with the NONOTCHES option.
  26. _____________________________________________________________________________
  27.  
  28. Changes made for 1.21:
  29.  
  30. - Disabled one error check when getting the extended inquiry data. Some
  31.   old device drivers seem to fail getting them correctly. I can't reproduce
  32.   this.
  33. _____________________________________________________________________________
  34.  
  35. Changes made for 1.20:
  36.  
  37. - Fixed a *fatal* bug that could have caused really serious crashes.
  38.   Forgot to cast correctly, leading trashing innocent memory. Outch!
  39.   *Sorry, sorry, sorry, sorry!*
  40. - Enhanced the Iomega extension output.
  41. _____________________________________________________________________________
  42.  
  43. Changes made for 1.19:
  44.  
  45. - Made the defect list format selectable, with autoselect for Iomega.
  46. - SCSIQuery prints now the extended INQUIRY data.
  47. - SCSIQuery detects now automatically whether a device name or a DOS
  48.   device driver is given.
  49. _____________________________________________________________________________
  50.  
  51. Changes made for 1.18:
  52.  
  53. - Added more sanity checks, fixed a possible enforcer hit. Thanks to 
  54.   Gene Heskett for reporting.
  55. - Changed the bad block default format to head/sector addressing rather
  56.   than bytes from index. This avoids trouble with Iomega devices.
  57. _____________________________________________________________________________
  58.  
  59. This tool prints all internal information of a SCSI device it can hold
  60. of, including the mode pages and the bad block lists. This might be 
  61. interesting for developers of SCSI software and hardware.
  62.  
  63. SCSIQuery replaces the older ProbSCSI which doesn't seem to run stable under
  64. certain (and in some sense broken) hardware, like the CyberSCSI device
  65. which doesn't seem to follow the RKRMs on each word. 
  66.  
  67.  
  68. Features:
  69.  
  70.     - Prints the device inquiry status
  71.     - Prints SCSI mode pages by their structure. It knowns most
  72.       HD and CD rom pages, and unknown pages are printed in hex dump.
  73.     - Prints the device capacity.
  74.     - Prints the defect list.
  75.     - Knows some Iomega extensions, most noticable for ZIP and JAZ.    
  76.       However, this is far from being complete due to the strange
  77.       information policy of Iomega.
  78.     - tested on the gvpscsi.device, the oktagon.device and the
  79.       (cyber)scsi.device. Should work on every device that follows
  80.       the RKRMs scsi.device documentations (roughly, at least).
  81.  
  82. To do:
  83.     Quite a lot, actually. However, it doesn't look I'm gonna have a
  84.     lot of time to develop this program further. It currently does what
  85.     it is supposed to do, but could do a lot better.
  86.  
  87.     - A GUI is missing. I'm just to lazy to write one in the current
  88.       state of this program.
  89.     - SCSIQuery doesn't allow to change or save the mode pages.
  90.     - Only mode pages for HD and CD are supported, no scanner/printer/
  91.       floptical and other SCSI device support. More mode pages might
  92.       be added on request.
  93.     - No LOG PAGES support yet.
  94.     - The readme is really a bit unhelpful. This program really lacks
  95.       a full detailed guide. However, lack of time... (-;
  96.  
  97.  
  98. Additional note:
  99.  
  100. Requests about what the output of this program means ARE NOT welcome. The
  101. SCSI-II specifications are available in public and they include all this
  102. information. 
  103.  
  104.  
  105. WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED
  106.  
  107. More SCSI mode page informations. I'm able to implement all official pages
  108. of the SCSI-II specifications since I've a copy of the SCSI specifications,
  109. however, there are more, vendor specific pages I've no idea about. Getting
  110. hold of the Iomega specifications - not the output of the program - 
  111. would really, really help.
  112.  
  113. If you've ANY information about these (not the official SCSI-II pages!) 
  114. additional pages, please, please PLEASE LEMME KNOW!
  115.  
  116. WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED - WANTED
  117. _________________________________________________________________________________
  118.  
  119. Installation:
  120.  
  121.     Just copy it whereever you want to keep it. Needs nothing more.
  122.  
  123.  
  124. Synopsis:
  125.  
  126. SCSIQuery HANDLER=DEVICE/A,UNIT/N,FLAGS/N,DEFECTLIST/K,NONOTCHES/S
  127.  
  128.     
  129.     HANDLER=DEVICE    the name of the DOS handler controlling a SCSI    
  130.             device. DO NOT specify handlers that are not
  131.             linked to SCSI devices, this will either abort
  132.             with an error message in the best case, or crashes
  133.             the system in the worst case. You *HAVE TO* place
  134.             a trailing colon ":", e.g. "ZIP:".
  135.             Alternatively, an exec style device, it *MUST*
  136.             end with ".device", e.g. "omniscsi.device"
  137.  
  138.     UNIT        the unit of the exec device to investigate, required
  139.             if an exec device name was specified.
  140.  
  141.     FLAGS        flags used for opening the specific device;
  142.             defaults to zero and are not required in most cases.
  143.  
  144.     DEFECTLIST    the type of defect list to inquiry from the device.
  145.             Possible defect list specifiers are:
  146.  
  147.         OFF        Do not print a defect list.
  148.         INDEX        Specify defaults as bytes from an index on 
  149.                 the tracks.
  150.         PHYSICAL    Specify defaults as physical head, cylinder
  151.                 and block.
  152.         BLOCK        Specify defects as block offsets from the
  153.                 start of the drive.
  154.         DEFAULT        Use the INDEX method for all drivers except
  155.                 for Iomega devices which use the PHYSICAL
  156.                 type.
  157.  
  158.     NONOTCHES    disables notch specific information. In case
  159.             SCSIQuery finds that the device to be investigated
  160.             has more than one notch, SCSIQuery will try to
  161.             print the notch dependent information separately
  162.             for each notch available. 
  163.  
  164. Examples:
  165.  
  166.  
  167. To investigate your system partition, try:
  168.  
  169. SCSIQuery DH0:
  170.  
  171.  
  172. To print information about your CD ROM, try:
  173.  
  174. SCSIQuery CD0:
  175.  
  176.  
  177. To query the SCSI device connected to the "gvpscsi.device", unit 6, try:
  178.  
  179. SCSIQuery gvpscsi.device UNIT=6
  180.  
  181.  
  182. To query the SCSI device connected to the "oktagon.device", unit 0, try:
  183.  
  184. SCSIQuery oktagon.device UNIT=0
  185.  
  186. _____________________________________________________________________________
  187.  
  188. Special thanks goes to Werner Müller for testing. This program was actually
  189. written to help him finding problems in his SCSI configuration.
  190. _____________________________________________________________________________
  191.  
  192.                          The THOR-Software Licence (v2, 24th June 1998)
  193.  
  194.  
  195. This License applies to the computer programs known as "SCSIQuery".
  196. The "Program", below, refers to such program. The "Archive" refers to the 
  197. original and unmodified package of distribution, as prepared by the author 
  198. of the Program. Each licensee is addressed as "you".
  199.  
  200.  
  201.  
  202. The Program and the data in the archive are freely distributable
  203. under the restrictions stated below, but are also Copyright (c)
  204. Thomas Richter.
  205.  
  206. Distribution of the Program, the Archive and the data in the Archive by a
  207. commercial organization without written permission from the author to any
  208. third party is prohibited if any payment is made in connection with such
  209. distribution, whether directly (as in payment for a copy of the Program) or
  210. indirectly (as in payment for some service related to the Program, or
  211. payment for some product or service that includes a copy of the Program
  212. "without charge"; these are only examples, and not an exhaustive enumeration
  213. of prohibited activities).
  214.  
  215.  
  216. However, the following methods of distribution
  217. involving payment shall not in and of themselves be a violation of this
  218. restriction:
  219.  
  220.  
  221. (i) Posting the Program on a public access information storage and
  222. retrieval service for which a fee is received for retrieving information
  223. (such as an on-line service), provided that the fee is not
  224. content-dependent (i.e., the fee would be the same for retrieving the same
  225. volume of information consisting of random data).
  226.  
  227.  
  228. (ii) Distributing the Program on a CD-ROM, provided that
  229.  
  230. a) the Archive is reproduced entirely and verbatim on such CD-ROM, including
  231. especially this licence agreement;
  232.  
  233. b) the CD-ROM is made available to the public for a nominal fee only,
  234.  
  235. c) a copy of the CD is made available to the author for free except for
  236. shipment costs, and
  237.  
  238. d) provided further that all information on such CD-ROM is redistributable
  239. for non-commercial purposes without charge.
  240.  
  241.  
  242. Redistribution of a modified version of the Archive, the Program or the
  243. contents of the Archive is prohibited in any way, by any organization,
  244. regardless whether commercial or non-commercial. Everything must be kept
  245. together, in original and unmodified form.
  246.  
  247.  
  248.  
  249.  
  250. Limitations.
  251.  
  252.  
  253. THE PROGRAM IS PROVIDED TO YOU "AS IS", WITHOUT WARRANTY. THERE IS NO
  254. WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  255. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  256. PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
  257. RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
  258. THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  259. SERVICING, REPAIR OR CORRECTION.
  260.  
  261.  
  262. IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE THE PROGRAM, THE ARCHIVE
  263. AND ALL DATA OF THIS ARCHIVE FROM YOUR STORAGE SYSTEM. YOU ACCEPT THIS
  264. LICENCE BY USING OR REDISTRIBUTING THE PROGRAM.
  265.  
  266.  
  267.                                                         Thomas Richter
  268. _____________________________________________________________________________
  269.  
  270. And now, have fun!
  271.  
  272.     Thomas        (November 1999)
  273.  
  274.  
  275. ============================= Archive contents =============================
  276.  
  277. Original  Packed Ratio    Date     Time    Name
  278. -------- ------- ----- --------- --------  -------------
  279.    38996   14904 61.7% 22-Nov-99 20:03:50 +SCSIQuery
  280.     9911    4028 59.3% 28-Nov-99 18:33:10 +SCSIQuery.readme
  281. -------- ------- ----- --------- --------
  282.    48907   18932 61.2% 29-Nov-99 20:35:00   2 files
  283.